home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / fish / 676-700 / 684 / al / al.doc < prev    next >
Text File  |  1995-03-18  |  5KB  |  145 lines
  1.  
  2.                        :::::::::::::::::::::::
  3.                        :::########::##::::::::
  4.                        :::##    ## :## :::::::
  5.                        :::## :::## :## :::::::
  6.                        :::######## :## :::::::
  7.                        :::##    ## :## :::::::
  8.                        :::## :::## :######::::
  9.                        ::::  ::::  ::      :::
  10.                        :::::::::::::::::::::::
  11.  
  12.                           - ARCHIVELISTER -
  13.  
  14.             (C) 1991 Oliver Wagner, All Rights Reserved
  15.  
  16. 1.Overview
  17. ----------
  18. AL  is a utility designed for viewing the contents of archives generated by
  19. file  archiver like ARC, LHARC or PKAZIP.  It can be used on FD-Disks where
  20. large  portions  (e.g.  source codes) are shipped in compressed form (think
  21. of  Fred's Library), or with BBS software to allow user to examine archives
  22. before download.
  23.  
  24. 2.Why use AL?
  25. -------------
  26. AL  can  be  used  to  examine several different archive formats (see list)
  27. although it is quite smaller than *ANY* of the archiver which's archives AL
  28. is  able to listen.  AL is fully standalone and be used from Workbench as a
  29. default  tool  for  archives.   AL  is  safe  for  use with certain corrupt
  30. archives:   Division  by  Zero  hacks (think of the percentage generation),
  31. "loop"  archives  (files with negative length cause some archiver to loop).
  32. AL  attempts  to  preserve  the  "look and feel" of the original archivers,
  33. although it will provide as much information as possible.
  34.  
  35. 3.Copyright
  36. -----------
  37. AL is (C) 1991 by
  38.  
  39.         Oliver Wagner
  40.     Landsberge 5
  41.     4322 Sprockhoevel
  42.         West Germoney
  43.     Voice ++49 (0)2339/7536
  44.         Data  ++49 (0)2339/5194 24h Support-BBS
  45.     O.WAGNER@AWORLD-II.ZER
  46.         Oliver Wagner of 2:241/5604@FIDO
  47.  
  48. AL  is  a  copyrighted  product,  all  rights reserved.  However, a limited
  49. license is granted to copy and use AL for free provided that
  50.  
  51.         - AL is distributed with this documentation file, "AL.doc"
  52.         - both AL and AL.doc are unmodified
  53.         - no charge is made for distributing or copying AL or AL.doc, nor
  54.           for media containing AL or AL.doc
  55.     - AL is not distributed or used with commercial software
  56.  
  57. IT  IS NOT ALLOWED TO INCLUDE <<AL>> WITH COMMERCIAL SOFTWARE WITHOUT PRIOR
  58. WRITTEN  AGREEMENT FROM THE OWNER OF THE COPYRIGHT OF AL!  REPEAT:  AL MUST
  59. NOT  BE  INCLUDED  WITH  COMMERCIAL SOFTWARE PACKAGES, LIKE BBS SOFTWARE OR
  60. *ANYTING* ELSE!
  61.  
  62. EVERY VIOLATION OF THESE RULES WILL BE PROSECUTED BY LAW!
  63.  
  64. THE AUTHOR MAKES NO WARRANTY FOR THE FUNCTIONALITY OF AL - USE IT COMPLETELY
  65. ON YOUR OWN RISK!
  66.  
  67. Bugreports, hints, suggestions and donations are welcome, but not required.
  68. What about sending me a nice postcard if you use and like AL?
  69.  
  70. 3.5.Center of doc file
  71. ----------------------
  72. This is (approx.) the center of the doc file.
  73.  
  74. 4.CLI Usage
  75. -----------
  76. Very simple:
  77.  
  78.         AL <archive-name>
  79.  
  80. AL will examine the archive type and output the contents, if possible.  You
  81. can  redirect output to a file in order to output AL's listing to an online
  82. user.
  83.  
  84. There  may be certain errors which AL can display; normally you could guess
  85. from  the  text  itself:   "backward  skip"  and  "division by zero" denote
  86. corrupt or bomb archives.
  87.  
  88. AL  is  fully "PURE" (thanks "cres.o") and can savely be made resident with
  89. 1.3 shell, 2.0 shell or the ARP resident manager.
  90.  
  91. 5.WB Usage
  92. ----------
  93. Set   AL  as  your  default  tool  for  the  archive  files;  if  the  user
  94. double-clicks  the  archive's  icon, AL will load, open a window and do the
  95. same  as  it  has  been  started from the CLI.  AL will wait for a <RETURN>
  96. before closing the window.
  97.  
  98. 6.Supported Archives
  99. --------------------
  100. Currently supported are:
  101.  
  102.         ARC
  103.         LHARC/LZ
  104.         PKAZIP/PKZIP
  105.         APE (percentage output is different, but that is a problem
  106.              of APE, not of AL :-)
  107.         ZOO (recognized, but not listed yet)
  108.         WARP (disk tracker)
  109.     ZAP (disk tracker)
  110.     ZOOM (disk tracker)
  111.     POWERPACKER datafiles
  112.     DMS (disk tracker)
  113.  
  114. More  archiver  and  disk-tracker  are  planned for the future; if you have
  115. information  about archive formats, feel free to suply them to me so that I
  116. can include that in future releases of AL.
  117.  
  118. 7.Last word
  119. -----------
  120. §$&%=/$"!
  121.  
  122. 8.History
  123. ---------
  124. V0.1:
  125.     first release version
  126. V0.2:
  127.     added WARP profiler
  128.     added ZAP recoginition
  129.     added APE lister
  130.     added ZIP date
  131.     cleaned up internal date generation
  132.     pure code; can be made resident now.
  133.     shipped crunched with TurboImploder; can still be made resident
  134. V0.3: (not public)
  135.     added ZOOM recognition
  136.     fixed some internal errors (e.g. ZOOM would be reported as
  137.       a ZOO archive...)
  138. V0.4: (not public)
  139.     added PP20 data files
  140. V0.5:
  141.     added DMS recognition and profiler
  142. V0.5a:
  143.     minor change: removed misrecogniation of LHA archives (sometimes
  144.     reported as corrupt ARC archives)
  145.